Everything For A Hacker/19990506-[HACK].iso/HEXEDIT/TCRASM/X390W32S.ZIP/X390READ.TXT

Text File | 1997-02-11 | 11KB | 228 lines

February 14, 1997             Tachyon 390 Cross Assembler
                                     Version 1.2.00
                      (C) Copyright 1997, Tachyon Software(R) LLC


This is the initial release of version 1.2 of the Tachyon 390 Cross Assembler.
The enhancements included in this release are listed below.


Note:
Some of the option abbreviations using in prior versions are no longer valid
for version 1.2.  The BATCH, DECK, LIBMAC and RENT options are now aliases
for the PROCESS(BATCH), OBJECT(DECK), PCONTROL(LIBMAC) and FLAG(RENT) options
respectively.  The abbreviations for the original forms are no longer valid.
The new abbreviations are: PSB, OD, PCLM and FRE respectively.  Also, the
abbreviation for FLAG(LINT) is now FLT instead of FLN and the abbreviation
for SYMNAME is now SY instead of SN.  In addition, the abbreviation for the
PRINTCTL option has been changed from PC to PR, allowing the PCONTROL option
to use the PC abbreviation for compatibility with IBM's High Level Assembler.

Because NODECK is now an alias for NOOBJECT, the option sequence OBJECT
followed by NODECK (or DECK followed by NOOBJECT) may not have the desired
effect.  A similar problem may occur when combining LIBMAC with PCONTROL
since each PCONTROL option completely replaces any previous setting.


- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

                                 Installation


OS/2 version -
   To install the OS/2 version, run the INSTALL program from the diskette.
   The assembler should work on OS/2 2.0 and all subsequent releases.

Windows 95 and Windows NT (Win32) version -
   To install the Win32 version, run the SETUP.EXE program from the diskette.
   Two versions of the assembler are provided for Windows.  The console-mode
   program (X390.EXE) can run on Windows 95 and Windows NT.  The GUI-mode
   program (X390WIN.EXE) should run on Windows 95, Windows NT 3.51 (or later).
   X390WIN.EXE may not run on Windows NT 3.50.  See the X390WIN.TXT file
   for more information about the GUI version.

Windows 3.1 (Win32s) version -
   To install the Win32s version, run the SETUP31.EXE program from the
   diskette.  Win32s 1.30 from Microsoft is required to run this version
   of the assembler on Windows 3.1 and Windows 3.11.  See the X390WIN.TXT
   file for more information.

UNIX versions -
   See the User's Guide.

Note: even though some operating systems support file and directory names
containing blanks, the assembler does not.  Do not try to install into a
directory containing blank characters in the name or try to access files or
directories with blank characters in their names using the assembler.


- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

                                  Change Log


Fixes in 1.2.00 (from 1.1.14)

*  DC operands with a duplication factor of 0 are validated.

*  For compatibility with the IBM assemblers, the dimension of subscripted
   set symbols in GBLA, GBLB, GBLC, LCLA, LCLB and LCLC is allowed to be zero.


Enhancements in 1.2.00 (from 1.1.14)

*  Support for the AHI, BRAS, BRC, BRCT, BRXH, BRXLE, CKSM, CHI, CLCLE, LHI
   MVCLE, MHI, MS, MSR, TMH and TML instructions has been added as well as
   support for the J, JE, JH, JL, JM, JO, JZ, JNE, JNH, JNL, JNM, JNO, and
   JNZ extended mnemonics.

*  The third operand of the EQU statement may now be an expression that
   evaluates to zero.

*  The PRINT statement accepts the LIBMAC and NOLIBMAC options.  This permits
   the printing of macro source to be controlled within the assembly.

*  If the label field of a statement contains *X390 and the new PROCESS(X390)
   option is in effect, the statement will be processed instead of being
   treated as a comment.  This allows statements specific to the Tachyon 390
   Cross Assembler (such as PRINT LIBMAC) to be hidden from IBM's assemblers.

*  If the PROCESS(X390) option is in effect, the EXEC X390 statement will
   be processed.  The supported forms are:
       EXEC X390 SET   FLAG(flags)
       EXEC X390 SET   USINGLIMIT(value)
       EXEC X390 SET   NOUSINGLIMIT
       EXEC X390 RESET FLAG
       EXEC X390 RESET USINGLIMIT
       EXEC X390 PUSH  FLAG
       EXEC X390 POP   FLAG
   These allow the FLAG and USINGLIMIT settings to be varied throughout the
   assembly.  All of the parameters supported by the FLAG option may be
   specified in the EXEC X390 SET statement.  If the value of the USINGLIMIT
   is altered, it effects subsequent USING statements, allowing the USINGLIMIT
   to be set for each USING.

*  The DECK option is an alias for the OBJECT(DECK) option and NODECK is
   an alias for the NOOBJECT option.  There are no longer abbreviations for
   the DECK and NODECK options.  The punch file name is specified via the
   new SYSPUNCH option.

*  The FLAG option supports the RENT, USINGDUP, USINGZERO, and USINGMULT
   parameters.  FLAG(RENT) replaces the RENT option and RENT and NORENT are
   now aliases for the FLAG(RENT) and FLAG(NORENT) options respectively.
   FLAG(USINGDUP) FLAG(USINGZERO), and FLAG(USINGMULT) are equivalent to
   the USING(WARN(1)), USING(WARN(2)), and USING(WARN(4)) options of IBM's
   High Level Assembler release 2.  The defaults for the FLAG option are now:
   FLAG(ALIGN,CONT,RECORD,USINGDUP,USINGZERO,USINGMULT) for consistency with
   the High Level Assembler.

*  The LANGUAGE option is now supported with the EN and UE parameters.

*  The LIST option accepts the 121, 133 and MAX parameters.  The listing
   file name is specified via the new SYSPRINT option.  In addition, the
   ESD, RLD, USINGMAP, DXREF and XREF are now similar to the format produced
   by IBM's High Level Assembler release 2.  As a direct result, the number
   of DSECTs in one assembly are no longer limited to 65535 and the number
   of DSECTs no longer reduces the maximum number of external symbols to
   less than 65535.

*  The MXREF option supports the SOURCE, XREF and FULL parameters.

*  The OBJECT option accepts the DECK and OMF parameters.  The object code
   file name is specified via the new SYSLIN option.

*  The PCONTROL option may be abbreviated as PC and the MCALL, MSOURCE and
   UHEAD parameters may be abbreviated as MC, MS and UH respectively.  In
   addition, LIBMAC is now a valid parameter and the LIBMAC and NOLIBMAC
   options are now aliases for the PCONTROL(LIBMAC) and NOPCONTROL options.

*  The PRINTCTL option has an abbreviation of PR instead of PC.

*  The PROCESS option has been introduced with the [NO]BATCH, [NO]JCL, and
   [NO]X390 parameters.  PROCESS(BATCH) replaces the BATCH option and the
   BATCH and NOBATCH options are now aliases for the PROCESS(BATCH) and
   PROCESS(NOBATCH) options.  PROCESS(JCL) causes all statements with a slash
   in the first column to be treated as single line comments, allowing JCL
   containing assembly source to be used as input directly to the assembler.
   PROCESS(X390) enables the EXEC X390 statements and causes any statements
   containing *X390 in the label field to be processed instead of being
   treated as comments.

*  The SIZE option is now supported and will cause some or all of the work
   files to be stored in memory instead of on disk.  This improves performance
   for all systems, especially Windows 3.1.  The SIZE option replaces the
   need for the TEMPMEM environment variable in OS/2.

*  The SYMNAME option supports the new XDC parameter which will cause the
   assembler to generate SYM records containing the entire symbol name for
   symbols longer than 8 characters.  Also, the SYMNAME option has an
   abbreviation of SY instead of SN.

*  The TERMREC option no longer exists.  Its function is specified via the
   TERM option.  The message file name is specified via the new SYSTERM
   option instead of the TERM option.

*  The USINGLIMIT option is supported.

*  The default for the XREF option is XREF(UNREFS) for compatibility with
   IBM's High Level Assembler.

*  If the X390LIB environment variable is not set and the NOSYSLIB option is
   in effect, the Library Search Path will be set to &D*.MAC for Windows and
   OS/2 or to &D&m.mac for UNIX.

*  The &X option variable may be used in the X390INI and X390LIB environment
   variables and the SYSLIB option value.  &X will be replaced with the name
   of the directory containing the Tachyon 390 Cross Assembler program files.


- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

Please use the form in the back of the User's Guide or
the one below when reporting problems to Tachyon Software:


        Tachyon 390 Cross Assembler Problem Report

Your name:       _______________________________________________
Company:         _______________________________________________
Mailing address: _______________________________________________
                 _______________________________________________
City:            _________________ State/Province: _____________
Country:         _________________ Zip/Postal Code: ____________
Telephone: Days: (___)____________ Evening: (___)_______________
Facsimilie:      (___)____________ E-mail: _____________________

Best method for us to contact you: _____________________________
Best time for us to contact you:   _____________________________

Product version: _________________ License serial: _____________
Operating System: ______________________________________________
    Please include the specific version, such as: OS/2 2.11,
    OS/2 Warp 3, OS/2 Warp Connect, OS/2 Warp 4, Windows 3.1,
    Windows 3.11 (please include the version of Win32s),
    Windows 95, Windows NT 3.50, Windows NT 3.51, Windows NT 4.0,
    Solaris 2.4, AIX 3.2.5, Linux 1.2, etc.

Problem description: ___________________________________________
________________________________________________________________
________________________________________________________________
________________________________________________________________

Use as many lines as needed to describe your problem.  Please include
the complete text of any related messages, including the message number.

The license serial is required information.  It is displayed when the
assembler is run, printed in the listing file, and can also be obtained
from the x390.ini file.  Your report will be assigned a number when it
is received.  This number can be used by you and Tachyon Software to
track the resolution of the problem.


- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

Tachyon Software LLC          e-mail: [e-mail]
12794 N. Sierra Circle        voice:  [phone]
Parker, CO 80134-8719  USA    FAX:    [phone]